Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Dialog Box Messages

GXFormatDialog

QuickDraw GX sends the GXFormatDialog message when the application displays
the Custom Page Setup dialog box. You can override the GXFormatDialog message to modify the behavior or appearance of the dialog box. Your override of the GXFormatDialog message must match the following formal declaration:

OSErr MyFormatDialog (gxFormat aFormat, StringPtr title, 
                      gxDialogResult, *aDialogResult);

aFormat

A reference to the format object.

title

The title of the dialog box. If you specify nil as the value of this parameter, the title "Custom Page Setup" is used.

aDialogResult

On return, a pointer to the selection made by the user in the dialog box.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXFormatDialog message when the user selects the Custom Page Setup menu item and an application subsequently calls the GXFormatDialog function to display the Custom Page Setup dialog box.

The default implementation of this message adds the standard printing panels and interface and then displays the dialog box.

You usually override this message to customize the dialog box by adding panels using the GXSetupDialogPanel function.

SPECIAL CONSIDERATIONS

You never send the GXFormatDialog message yourself.

You must forward the GXFormatDialog message to other message handlers. Add your panels and then forward the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXFormatDialog function is described in Inside Macintosh: QuickDraw GX Printing.

The GXSetupDialogPanel function is described on page 5-28 in the chapter "Printing Functions for Message Overrides."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help